home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / gltexcoord.z / gltexcoord
Encoding:
Text File  |  2001-04-17  |  12.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111dddd,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffff,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiii,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222dddd,,,,
  10.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffff,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiii,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333dddd,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffff,,,,
  11.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiii,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444dddd,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffff,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiii,,,,
  12.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssss,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssssvvvv,,,,
  13.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssssvvvv,,,,
  14.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssssvvvv,,,,
  15.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ddddvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffffvvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiiivvvv,,,, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssssvvvv - set the
  16.      current texture coordinates
  17.  
  18.  
  19. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  20.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111dddd( GLdouble _s )
  21.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffff( GLfloat _s )
  22.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiii( GLint _s )
  23.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssss( GLshort _s )
  24.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222dddd( GLdouble _s,
  25.                         GLdouble _t )
  26.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffff( GLfloat _s,
  27.                         GLfloat _t )
  28.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiii( GLint _s,
  29.                         GLint _t )
  30.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssss( GLshort _s,
  31.                         GLshort _t )
  32.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333dddd( GLdouble _s,
  33.                         GLdouble _t,
  34.                         GLdouble _r )
  35.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffff( GLfloat _s,
  36.                         GLfloat _t,
  37.                         GLfloat _r )
  38.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiii( GLint _s,
  39.                         GLint _t,
  40.                         GLint _r )
  41.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssss( GLshort _s,
  42.                         GLshort _t,
  43.                         GLshort _r )
  44.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444dddd( GLdouble _s,
  45.                         GLdouble _t,
  46.                         GLdouble _r,
  47.                         GLdouble _q )
  48.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffff( GLfloat _s,
  49.                         GLfloat _t,
  50.                         GLfloat _r,
  51.                         GLfloat _q )
  52.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiii( GLint _s,
  53.                         GLint _t,
  54.                         GLint _r,
  55.                         GLint _q )
  56.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssss( GLshort _s,
  57.                         GLshort _t,
  58.                         GLshort _r,
  59.                         GLshort _q )
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  75.      _s, _t, _r, _q
  76.               Specify _s, _t, _r, and _q  texture coordinates.  Not all parameters
  77.               are present in all forms of the command.
  78.  
  79. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  80.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ddddvvvv( const GLdouble *_v )
  81.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ffffvvvv( const GLfloat *_v )
  82.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111iiiivvvv( const GLint *_v )
  83.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111ssssvvvv( const GLshort *_v )
  84.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ddddvvvv( const GLdouble *_v )
  85.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ffffvvvv( const GLfloat *_v )
  86.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222iiiivvvv( const GLint *_v )
  87.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222ssssvvvv( const GLshort *_v )
  88.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ddddvvvv( const GLdouble *_v )
  89.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ffffvvvv( const GLfloat *_v )
  90.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333iiiivvvv( const GLint *_v )
  91.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333ssssvvvv( const GLshort *_v )
  92.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ddddvvvv( const GLdouble *_v )
  93.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ffffvvvv( const GLfloat *_v )
  94.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444iiiivvvv( const GLint *_v )
  95.      void ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444ssssvvvv( const GLshort *_v )
  96.  
  97.  
  98. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  99.      _v    Specifies a pointer to an array of one, two, three, or four
  100.           elements, which in turn specify the _s, _t, _r, and _q texture
  101.           coordinates.
  102.  
  103. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  104.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd specifies texture coordinates in one, two, three, or four
  105.      dimensions. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd1111 sets the current texture coordinates to (_s, 0, 0,
  106.      1); a call to ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd2222 sets them to (_s, _t, 0, 1).  Similarly,
  107.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd3333 specifies the texture coordinates as (_s, _t, _r, 1), and
  108.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd4444 defines all four components explicitly as (_s, _t, _r, _q).
  109.  
  110.      The current texture coordinates are part of the data that is associated
  111.      with each vertex and with the current raster position. Initially, the
  112.      values for _s, _t, _r, and _q are (0, 0, 0, 1).
  113.  
  114. NNNNOOOOTTTTEEEESSSS
  115.      The current texture coordinates can be updated at any time.  In
  116.      particular, ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd can be called between a call to ggggllllBBBBeeeeggggiiiinnnn and the
  117.      corresponding call to ggggllllEEEEnnnndddd.
  118.  
  119.  
  120. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  121.      On OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems, use of the texture q coordinate to achieve
  122.      projective texture effects will be processed on a per-vertex basis
  123.      instead of a per-pixel basis, unless the the texture matrix is set up to
  124.      be projective.  (A projective texture matrix is defined to be one in
  125.      which any of the 13th, 14th or 15th elements is non-zero.)  In addition,
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))                 OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                 ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      if either two-sided lighting or fragment lighting is in effect,
  141.      projective texture effects will always be processed on a per-vertex
  142.      basis.
  143.  
  144.  
  145. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  146.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS
  147.  
  148. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  149.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ggggllllVVVVeeeerrrrtttteeeexxxx
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.